home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / netmail / blueq160.zip / BLUEQWK.DOC < prev    next >
Text File  |  1996-01-08  |  20KB  |  432 lines
  1.  
  2.           BlueQWK v1.60 - BLUEQ160.ZIP - 08-January-1996
  3.           Copyright (C) 1992,96 Simple Solutions Software,
  4.           All Rights Reserved.
  5.  
  6.           Residence:   Geoffrey Sy
  7.                        1322-14 Blevins Place
  8.                        Toronto ON  M5A 3M5
  9.                        Canada
  10.  
  11.           FidoNet:     1:250/814
  12.  
  13.           InterNet:    sy@sshq.tor250.org
  14.                        rn.4261@rose.com
  15.                        ae873@torfree.net
  16.  
  17.           Support BBS: CAP/CANADA (416) 287-0935 v.Everything
  18.                                   (416) 287-0234 v.Everything
  19.                        CAP/USA    (708) 854-0255 v.Everything
  20.                          Conference: CL_SimpleSoln #4
  21.  
  22.           Latest versions of most QWK utilities, including BlueQWK, can
  23.           be found on The Lunatic Fringe BBS 214-235-5288 (1:124/2113).
  24.  
  25.           FTP: ftp.coast.net /SimTel/msdos/offline on the internet for
  26.           the latest version of your favourite offline mail utilities.
  27.  
  28.           ═════════════════════════════════════════════════════════════
  29.           BlueQWK converts  BlueWave mail packets  to a format readable
  30.           by QWK mail readers.  It is designed to interface seamlessly
  31.           with most DOS-based QWK off-line mail readers.
  32.  
  33.           INSTALLATION for 1stReader (as well as other OLMRs):
  34.  
  35.               1.  Copy BLUEQWK.EXE into your 1stReader directory.  If
  36.                   using 1stReader v1.10, unZIP 1ST11.RDR into your
  37.                   1stReader directory.  If using 1stReader v2.0 unZIP
  38.                   1ST20.RDR into your 1stReader directory.
  39.  
  40.           OPERATION:
  41.  
  42.               1.  This version of BlueQWK needs more memory than older
  43.                   versions, so you might need to enable 1stReader's
  44.                   SuperShell to free up some memory before executing
  45.                   BlueQWK.
  46.  
  47.               2.  When you start 1stReader, append the switch /QWK:* to
  48.                   the 1stReader command line.  This switch can also go
  49.                   into your SWITCHES.1ST file.
  50.  
  51.           BlueQWK automatically copies BlueWave *.INF files into same
  52.           directory as itself.  This allows for conversion of replies
  53.           without the need for a BlueWave packet to be present.
  54.  
  55.           The reply packet for uploading to the BlueWave door still
  56.           have the .REP extension.  1st Reader doesn't have any hooks
  57.           to take care of this.  The 1st Reader /REP: NEW switch won't
  58.           work in this case unless you want all your reply packets to
  59.           have the .NEW extension.  This isn't a problem because the
  60.           replies packet is automatically renamed to <BBS_ID>.NEW when
  61.           the Bluewave door received it.
  62.  
  63.           There is an internal hook that 1stReader provide for BW-QWK
  64.           conversion.  It does not work when writing replies without
  65.           the presence of a mail packet.  This hook causes DOS to issue
  66.           'Bad command or file name' when reading Bluewave packets.  If
  67.           this DOS error annoys you, download DLXTEXT.EXE or QMTEXT.EXE
  68.           from Sparky to edit your 1STTEXT file.  Place the word REM in
  69.           front of records #297, 298, and 299 in 1STTEXT to fix this.
  70.  
  71.           ═════════════════════════════════════════════════════════════
  72.           INSTALLATION for other readers:
  73.  
  74.               1.  Put BLUEQWK.EXE into your reader directory or
  75.                   anywhere on your DOS PATH.
  76.  
  77.               2.  Replace the compression/decompression utilities with
  78.                   batch files.  Then do some simple batch programming.
  79.  
  80.                   Included in this package are several files with the
  81.                   .RDR extension.  These are .ZIP files containing
  82.                   sample .CFG and .BAT files for use with other mail
  83.                   readers.  They also contain configuration files for
  84.                   the mail reader, so becareful not to overwrite your
  85.                   mail reader's configuration files.  These files are:
  86.  
  87.                   DLX12.RDR - For use with Sparkware's Deluxe² v1.2x
  88.                               and probably older versions as well.
  89.                   OLX22.RDR - For use with OLX v2.2.  Will probably
  90.                               work with SLMR and earlier OLX versions
  91.                   OLX30.RDR - For use with OLX v3.1.52.  May work with
  92.                               prior release of OLX v3.xx
  93.                   SR140.RDR - For use with Speed Read v1.40.  May work
  94.                               with earlier and later versions.
  95.                   RM130.RDR - For use with RoboMail v1.30.  May work
  96.                               with earlier and later versions.
  97.  
  98.                   Unzip the appropriate .RDR into the same directory as
  99.                   BLUEQWK.EXE.  Then configure your reader to call the
  100.                   appropriate PACKER/UNPACKER .BATch file. Please refer
  101.                   to the README.TXT file inside the .RDR files for more
  102.                   information.
  103.  
  104.               3.  You may need to change the extension of the BW mail
  105.                   packets to *.QWK inorder for your mail reader to find
  106.                   the mail packets.
  107.  
  108.               If the above steps don't work for your OLMR, these
  109.               information may help:
  110.  
  111.                   The basic command line to run BlueQWK follows:
  112.  
  113.                   BLUEQWK BBS_ID conversion_method
  114.  
  115.                   - BBS_ID can be anything that contains the name of
  116.                     the QWK/REP packet.  This may include the mail
  117.                     packet name as passed by your mail reader to the
  118.                     compression/decompression utilities.  If the BBS_ID
  119.                     is not known, use an asterisk '*' to let BlueQWK
  120.                     find/guess the BBS_ID.
  121.  
  122.                   - conversion_method has 3 options:
  123.  
  124.                    1. BW-QWK converts BlueWave mail packet to QWK for
  125.                       reading with your QWK reader.
  126.                    2. BW-REP converts BlueWave replies to .REP for
  127.                       re-editing them with your QWK reader.
  128.                    3. REP-BW converts .REP to BlueWave for uploading
  129.                       to the BlueWave door
  130.  
  131.                   The BLUEQWK.CFG needs the following info:
  132.  
  133.                     Line 1: Directory of QWK work directory.  This is
  134.                             where your mail reader decompress the mail
  135.                             packet to. Most readers will change to this
  136.                             directory before opening the mail packet,
  137.                             so a ".\" (without the quotes) will work in
  138.                             most cases.
  139.  
  140.                     Line 2: Directory of REP work directory.  This is
  141.                             where BlueQWK expects to find the reply
  142.                             file created by your mail reader.  BlueQWK
  143.                             uses this directory to store the converted
  144.                             Bluewave replies.  Most readers don't use a
  145.                             separate directory for this purpose.  In
  146.                             such case, create a work directory and copy
  147.                             the reply file into it.  Please refer to
  148.                             OLX22.RDR for the solution to this problem.
  149.  
  150.                     Line 3: Optional switches for BlueQWK.  Currently
  151.                             these switches are supported:
  152.  
  153.                             /Quiet
  154.                                Tells BlueQWK not to list the header of
  155.                                messages it processed.
  156.  
  157.                             /NoNDX
  158.                                Tells BlueQWK not to create the QWK
  159.                                index (*.NDX) files.
  160.  
  161.                             /1stBM
  162.                                 Fix a problem with 1stReader v2's "new"
  163.                                 book-mark scheme.  If BlueQWK finds
  164.                                 BOOKMARK.DAT in the QWK work directory,
  165.                                 it will not attempt to convert the BW
  166.                                 mail packet.  This new book-mark scheme
  167.                                 is unquestionably the worst function
  168.                                 found in 1stReader.
  169.  
  170.                             /NoERR
  171.                                 Suppress error messages such as "No
  172.                                 Replies found" or "No BW mail packet
  173.                                 found".
  174.  
  175.                   These .CFG options may be appended to the command
  176.                   normal BlueQWK command line if they do not exceed the
  177.                   DOS command line limit of 128 characters.  For
  178.                   example:
  179.  
  180.                   BLUEQWK BBS_ID cvt_method qwk_dir rep_dir /switches
  181.  
  182.           ═════════════════════════════════════════════════════════════
  183.           STANDALONE OPERATION:
  184.  
  185.             1. Create a temporary work directory and decompress your
  186.                Blue Wave mail packet into it.
  187.  
  188.             2. Copy BLUEQWK.EXE to a directory on your DOS path.  Make
  189.                sure it resides a directory different from the work
  190.                directory created in step 1.
  191.  
  192.             3. Execute BlueQWK with the following options:
  193.  
  194.                  BLUEQWK * BW-QWK .\ .\
  195.  
  196.             4. If the above step is sucessful, re-compress the content
  197.                of work the directory packet into a QWK packet.
  198.  
  199.             5. If you cannot perform perform the above 4 steps, then
  200.                you really need help in PC operation basics.  I can
  201.                provide personal one-on-one in-home training starting
  202.                from $25.00 per hour plus expenses.
  203.  
  204.           ═════════════════════════════════════════════════════════════
  205.           That's  all there's  to it.   You can now  read BlueWave mail
  206.           packets with your favorite QWK reader.
  207.  
  208.           I like to think this document short, complete and helpful.
  209.           If you have problems with the program, please do not hesitate
  210.           to contact me.
  211.  
  212.           ═════════════════════════════════════════════════════════════
  213.           MAILER READER INTERFACE FOR BLUEQWK: For QWK reader authors:
  214.  
  215.           These simple additions to any mail reader would be helpful
  216.           for third party programs to interface with the mail reader.
  217.  
  218.           To interface with BlueQWK, the mail reader should provide the
  219.           ability to run 3 .BAT files and pass 3 parameters to BlueQWK.
  220.  
  221.           The .BAT files:
  222.  
  223.              1. POSTQWK.BAT - Run after the reader decompress the .QWK
  224.                               packet.
  225.  
  226.              2. POSTREP.BAT - Run after the reader decompress the .REP
  227.                               packet.
  228.  
  229.              3. PREREP.BAT  - Run before the reader compress the .MSG
  230.                               into a .REP file.
  231.  
  232.           These .BAT files can be any name, as long as they are known
  233.           to the users of the mail reader (ie: documented).
  234.  
  235.           The Parameters:
  236.  
  237.              1. QWK work path - Path to the directory where the QWK
  238.                                 packet was decompressed to.
  239.  
  240.              2. REP work path - The directory where the <BBS_ID>.MSG is
  241.                                 stored.
  242.  
  243.              3. The <BBS_ID>  - The name of the QWK file.  This is not
  244.                                 necessary, but can reduce error if
  245.                                 BlueQWK doesn't have to guess.
  246.  
  247.           Optional:
  248.  
  249.           Make the reader recognize the Bluewave naming format.  The
  250.           current naming convention for Bluewave format folows:
  251.  
  252.            <BBS_ID>.DA#  - DA is the first 2 letter of the day followed
  253.                            by a number 0 to 9.  Thus the first mail
  254.                            packet downloaded on Monday would have .MO0
  255.                            as the file extension.
  256.  
  257.            <BBS_ID>.###  - This newer naming convention gives the file
  258.                            extension any number between 000 to 999.
  259.  
  260.            <BBS_ID>.NEW  - The Bluewave reply packet should have .NEW
  261.                            as the file extension.
  262.  
  263.           ═════════════════════════════════════════════════════════════
  264.           REVISION HISTORY:
  265.  
  266.           08-Jan-1996 - v1.60 -----------------------------------------
  267.  
  268.            ■ Additional command line parameters replace the need for
  269.              BLUEQWK.CFG.  DOS only supports command lines up to 128
  270.              characters, use BLUEQWK.CFG if paths and command line
  271.              options exceed this limit.
  272.  
  273.            ■ BlueQWK will now accept parameter #3 as the QWK work
  274.              directory, #4 as REP work directory, everything after are
  275.              optional switches.  For example:
  276.  
  277.                BLUEQWK bbs_id cvt qwk_dir rep_dir
  278.  
  279.            ■ For registered users with internet email address, please
  280.              request your 386/486 optimized version of BlueQWK.  This
  281.              386 version will not work without a valid registration key.
  282.  
  283.           11-Dec-1994 - v1.55 -----------------------------------------
  284.  
  285.            ■ The previous update caused BlueQWK to load the .INF file to
  286.              the wrong memory address under certain conditions.  This
  287.              can cause the computer to lock-up.
  288.  
  289.            ■ Run time errors are now logged to ERRORLOG.GS.
  290.  
  291.           09-Dec-1994 - v1.54 -----------------------------------------
  292.  
  293.            ■ Increased memory requirement to process large .INF files.
  294.  
  295.            ■ Instead of exiting quietly, error messages are now
  296.              displayed.
  297.  
  298.            ■ Added /NoERR to suppress display of error messages.
  299.  
  300.           15-Sep-1994 - v1.53 -----------------------------------------
  301.  
  302.            ■ Added the ability to convert the .INF to a CONTROL.DAT
  303.              with-out the need for the rest of the mail packet.  Needed
  304.              for SPEED Read.
  305.  
  306.            ■ Brought back the asterisk '*'.  If the mail packet is not
  307.              known, use the the asterisk in place of the BBS_ID and
  308.              BlueQWK will automatically locate the BBS_ID.
  309.  
  310.            ■ Added configurations for SPEED READ and RoboMail.
  311.  
  312.           12-Aug-1994 - v1.52 -----------------------------------------
  313.  
  314.            ■ Updated to comply with the official Bluewave specification.
  315.  
  316.            ■ Included sample configuration files for other mail readers.
  317.  
  318.            ■ Added options /Quiet, /NoNDX, /1stBM
  319.  
  320.           28-Feb-1994 - v1.51 -----------------------------------------
  321.  
  322.            ■ Updated contact information.
  323.  
  324.           10-Nov-1993 - v1.50 -----------------------------------------
  325.  
  326.            ■ Updated for compatibility with other versions of the
  327.              Bluewave door. Previous versions of BlueQWK only worked
  328.              with Remote Access and QuickBBS versions of the Bluewave
  329.              door.
  330.  
  331.            ■ Beginning with this version, BlueQWK is now Shareware.
  332.              Please register if you it regularly.
  333.  
  334.           19-Jul-1993 - v1.31 -----------------------------------------
  335.  
  336.            ■ Minor cosmetic to the R2B module.  If you can read fast
  337.              enough, you'll see the messages being converted.
  338.  
  339.           25-Jun-1993 - v1.30 -----------------------------------------
  340.  
  341.            ■ I've moved recently.  Please note the new address.
  342.  
  343.            ■ More compatible with the BlueWave door.
  344.  
  345.            ■ Added the 3rd conversion module BW-REP.
  346.  
  347.            ■ Combined all 3 conversion modules into a single .EXE.
  348.  
  349.            ■ Command line options changed.
  350.  
  351.           25-Feb-1993 - v1.20 -----------------------------------------
  352.  
  353.            ■ Speeded up some more
  354.  
  355.            ■ Added some junk into the .UPI file to cure some BlueWave
  356.              door rejecting good replies as duplicates.
  357.  
  358.            ? I still don't have a clue what some of the junk in the .UPI
  359.              file is.  So don't expect this to be 100% compatible with
  360.              all BlueWave doors.  Anyone been able to get the BlueWave
  361.              structure from the author?
  362.  
  363.           10-Feb-1993 - v1.10 -----------------------------------------
  364.  
  365.            ■ Speeded up by at least 2 times
  366.  
  367.            ■ R2B converts from .REP to BlueWave
  368.  
  369.           15-Nov-1992 - v1.00 -----------------------------------------
  370.  
  371.            ■ Initial Release
  372.  
  373.           ═════════════════════════════════════════════════════════════
  374.           REGISTRATION:
  375.  
  376.           If you have questions,  bugs, comments or suggestions, please
  377.           email me.  Registered users of my other Shareware packages may
  378.           contact me using the voice number in the registration document.
  379.  
  380.           Since BlueQWK  is user supported software, I don't expect you
  381.           to register if you don't like it or if it doesn't meet your
  382.           needs.  Just stop  using it after a reasonable  trial period.
  383.           BlueQWK is not crippled in any way, but some minor annoyance
  384.           features may be active in unregistered mode.
  385.  
  386.           BlueQWK  is an  on-going  project, it  will  be enhanced  and
  387.           updated as long as I can financially afford to do so.  If you
  388.           like the program  and use it  regularly, please register  it.
  389.           The registration cost is a one-time  fee of $5.00.  With the
  390.           registration  you'll  receive  unlimited  voice  support  and
  391.           upgrades.   Your registration encourages further development,
  392.           enhancements and my continued support of the product.  Please
  393.           send your registration in the form of a Money Order, Personal
  394.           cheque, or Cashier's cheque to the above address.
  395.  
  396.           ═════════════════════════════════════════════════════════════
  397.           STANDARD DISCLAIMER:
  398.  
  399.           This program is provided on an "AS IS" basis.  No warranty of
  400.           any kind is expressed  or implied.  I take  no responsibility
  401.           for  any damage caused directly or indirectly from the use or
  402.           the  inability to  use this  program.   Only features  in the
  403.           current .EXE, including bugs, critters and anything else that
  404.           might be pressent, are available to the users.  Users are not
  405.           to expect future upgrades or additional features. The program
  406.           will not  change to suit the needs of the users if such needs
  407.           change  in  the  future.   By  using  this  program the  user
  408.           automatically accepts these terms and conditions.
  409.  
  410.           ═════════════════════════════════════════════════════════════
  411.           COPYRIGHTS:
  412.  
  413.           Products mentioned  in this documentation are  Copyrighted or
  414.           Trademarks of their respective holders:
  415.  
  416.           1stReader, Deluxe:       Mark "Sparky" Herring of Sparkware.
  417.                                    The original creator of the popular
  418.                                    QWK mail standard.
  419.  
  420.           BlueWave:                George   Hatchew  of   Cutting  Edge
  421.                                    Computing.  The original creator of
  422.                                    the BlueWave format.
  423.  
  424.           OLX:                     Mustang Software Inc.
  425.  
  426.           SPEED READ:              Jim Smith.
  427.  
  428.           RoboMail:                Parson Consulting.
  429.  
  430.           ═════════════════════════════════════════════════════════════
  431.  
  432.